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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 



This Technical Specification (TS) has been produced by ETSI Technical Committee Machine-to-Machine 
communications (M2M). 
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1 Scope 

The present document contains BBF TR-069 compatible Data Model for ETSI M2M. 



References 



References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[1] ETSI TS 102 690: "Machine-to-Machine communications (M2M); Functional architecture". 

[2] ETSI TS 102 921: "Machine-to-Machine communications (M2M); mla, dia and mid interfaces". 

[3] BBF TR-069: "CPE WAN Management Protocol, Issue 1", Amendment 4, July 2011, Protocol 

version 1.3. 

NOTE: Available at http://www.broadband-forum.org/technical/download/TR-069 Amendment-4.pdf. 

[4] BBF TR-106: "Data Model Template for TR-069-Enabled Devices", Issue 1, Amendment 6, 

July 2011. 

NOTE: Available at http://www.broadband-forum.org/technical/download/TR-106 Amendment-6.pdf . 

[5] BBF TR-181: "Device Data Model for TR-069", Issue 2 Amendment 6, November 2012. 

[6] IETF RFC 3986: "Uniform Resource Identifier (URI): Generic Syntax". 

[7] POSIX.1-2008: "The Open Group Technical Standard Base Specifications", Issue 7. 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

[i.l] Void. 

[i.2] ETSI TR 102 725: "Machine to Machine Communications (M2M); M2M definitions". 



3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 102 725 [i.2] apply. 
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3.2 Symbols 

For the purposes of the present document, the symbols given in TR 102 725 [i.2] apply. 

3.3 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 102 725 [i.2] apply. 



General principles 



In its TR-069 [3] the BroadBand Forum specifies a protocol for communication between a CPE (Customer Premises 
Equipment) and an ACS (Auto-Configuration Server). 

Any TR-069 compliant device (the CPE) has to follow the data model as described in the TR-106 [4] and TR-181 [5]. 

ETSI M2M defines a Device Management function that allows to remotely configure the M2M Devices by using 
already existing Device Management protocols (e.g. BBF-TR-069, OMA-DM, etc.). Due to the RESTfull nature of the 
interface with the M2M Applications, some ETSI Management Objects are specified and modelled as REST resources 
in[l]. 

Some of these ETSI resources may be mapped on already existing Data Models/Management Objects as defined by 
BBF or/and OMA. The corresponding mapping rules are specified in [2]. 

Some other resources do not correspond to any existing Data Models/Management Objects as defined by BBF or/and 
OMA. The present document defines the corresponding BBF-TR-069 compatible Data Model. 

The data model for a TR-069 enabled device has to follow a common set of requirements (see in the TR-181 [5]). A 
data hierarchy is specified based on a single Root Object which is called "Device". Each Management Object is a 
sub-element of this Root object. 

Broadband Forum decided to implement the ETSI Management Objects at root level of the tree. It means that the ETSI 
Management Objects are directly implemented at "Device" level. 

The 3 ETSI Management Objects (etsiSclMo, etsiAreaNwklnfo, and etsiAreaNwkDevicelnfo) are gathered together in 
one single ETSI M2M Management Object. 

When a data structure is represented by comma separated list of type "string", any whitespace or comma characters 
contained in an item of such a list shall be escaped using percent as defined in Section 3.2.3 of [4]. 



ETSI M2M Data Model 



The BBF TR-69 compliant ETSI M2M data model is specified by the Broadband Forum in TR-181 Issue 2 
Amendment 6 [5]. A copy of the detailed data model is shown in annex A (informative) of the present document. 

The exact mapping between the attributes and sub-resources of the ETSI resource and the elements of BBF TR-69 
compliant ETSI M2M data model is specified in annex E of [2]. 
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Annex A (informative): 

BBF Data IVIodel for ETSI M2M IVIanagement Objects 

The present annex provides a copy of the data model extracted from BBF TR-181 Issue 2 Amendment 6 [5], it is 
reproduced here for information. 

Table A.1 : BBF Data Model for ETSI M2M Management Objects 



Name 


Type 


Write 


Description 


Object 
Default 


Version 


Device. 


object 


- 


The top-level object for a Device. 


- 


2.0 


Device.ETSIM2M. 


object 




The ETSI M2M object represents the 
management object for the Remote Entity 
Functions (REIVI) functions defined in the 
M2M Functional Architecture [1]. 




2.99 


SCLNumberOfEntries 


unsignedint 


- 


The number of entries in the SCL table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}. 


object 


W 


This object represents an instance of a 
Service Capability Layer (SCL) for a M2IVI 
device or gateway. 

Each device or gateway has only one SCL 
instance per M2M Service Provider. The 
REM functionality in this SCL can only 
manage the subtree of the specific SCL 
object that corresponds to it. 
The SCL IVIAY be maintained by the ACS or 
by the CPE. 

When the SCL provides the administration of 
an SCL that is represented as a 
SoftwareModules.ExecutionUnit the SCL is 
maintained in the 

SoftwarelVlodules.ExecutionUnit.{i}.Referenc 
es parameter. 

Section 5.1 .2 of the M2M Functional 
Architecture [1] describes the high level 
event flows for SCL registration. 
Section 9.3.2.6.2 of the IVI2M Functional 
Architecture [1] describes the 
creation/registration of SCLs. 
Section 9.3.2.6.4 of the M2M Functional 
Architecture [1] describes the update/re- 
registration of SCLs. 
Section 9.3.2.6.5 of the IVI2M Functional 
Architecture [1] describes the 
deletion/deregistration of SCLs. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE shall choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 
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[ Name 


Type 


Write 


Description 


Object 
Default 


Version 


Alias 


string (64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in 

Section 3.6.1 [3] and described in 

Appendix 11/ [3], the following mandatory 

constraints shall be enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 


AnnouncedToSCLList 


string 


W 


Comma-separated list of strings. The list 
represents an unordered set of URIs [6]. 
A list item is a URI string that represents a 
SCL to which the SCL will announce original 
(local) resources. 

The AnnouncedToSCL has an interest in the 
discovery of the local resource. Section 
9.2.1.14 Announced Resource of the M2M 
Functional Architecture [1] provides a 
description of this behaviour of an 
Announced Resource. 
Section 9.3.2.28 of the M2M Functional 
Architecture [1] and Section 10.3.2.7 of the 
l\/12M mla, dia and mid Interfaces [2] 
describes the process of announcing and 
denouncing of resources within a SCL. 




2.99 


SAFPolicySetNumberOfEntries 


unsignedint 


- 


The number of entries in the SAFPolicySet 
table. 


- 


2.99 


AreaNwklnstanceNumberOf Entries 


unsignedint 


- 


The number of entries in the 
AreaNwklnstance table. 


- 


2.99 


AreaNwl<DevicelnfolnstanceNumber 
OfEntries 


unsignedint 


- 


The number of entries in the 
AreaNwkDevicelnfolnstance table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNwkD 
evicelnfolnstance.{i}. 


object 




The IVI2M Area Network Device Information 
provides the administration capability to the 
SCL for maintenance of I\/I2M Devices (D', d) 
that are attached to this SCL instance. 
While discovery and identification of devices 
by the M2M Gateway or Device (CPE) is 
implementation specific, each device is 
represented by an instance of the Hosts. Host 
table. 

When the IVI2M Device is managed by the 
CWMP endpoint of the CPE, the 
AreaNwkDevicelnfolnstance is expected to 
be referenced by an instance of one of the 
following tables: 

ManagementServer.EmbeddedDevice 
ManagementServer.VirtualDevice 
Section 5.3.5 of the I\/I2M Functional 
Architecture [1] describes the REIVI 
functionality expected of a SCL to a M2M 
Device. 

This object instance provides the 
administration properties required by a SCL 
to remotely manage an instance of a IVI2M 
Device within a M2M area network. 
A M2M Device is associated with an instance 
of an AreaNwklnstance. 




2.99 
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Name 


Type 


Write 


Description 


Object 
Default 


Version 








This table contains parameters and 
information of the M2M Device related to 
each AreaNwklnstance instance. 
Instances of this table are created and 
deleted by the CPE. The ACS IVIAY modify 
the writeable parameters of this object 
instance but it is possible that the value set 
by the ACS is not retained between reboots 
of the I\/I2M Device. 






AreaNwklnstance 


string 


- 


The value shall be the path name of a row in 
the AreaNwklnstance table. 


- 


2.99 


Host 


string 




Comma-separated list of strings. Each list 
item shall be the path name of the 
Hosts. Host table entry that represents an 
active or inactive M2M Device. If the 
referenced object is deleted, the 
corresponding item shall be removed from 
the list. 




2.99 


ListOfDeviceNeighbors 


string 




Comma-separated list of strings. Each list 
item shall be the path name of a row in the 
Hosts. Host table. If the referenced object is 
deleted, the corresponding item shall be 
removed from the list. References all the 
Hosts. Host table entries, whether active or 
inactive, that represent the reachable 
neighbours of this M2M Device (D' or d). 




2.99 


!tOf DeviceAppI ications 


ing 




Comma-separated list of strings. The list is 
an unordered set of URIs [6]. 
A list item is an URI string that represents an 
application id (APP-ID) for the I\/I2M D'A 
applications residing on the I\/I2M Device for 
the associated AreaNwklnstance. 
Table B.58 of the IVI2M Functional 
Architecture [1] describes this parameter. 




2.99 


Sleeplnterval 


unsignedint 


W 


The interval, in seconds, between sleep 

periods for the device. 

A value of represents a device that does 

not sleep. 

NOTE: When this value is modified, the 
CPE could modify the 
Sleeplnterval for this M2M Device 
in other Area Networks. 




2.99 


SleepDuration 


unsignedint 


W 


The duration, in seconds, of a sleep period. 

The value represents an unknown value. 

NOTE: When this value is modified, the 
CPE could modify the 
SleepDuration for this M2M 
Device in other Area Networks. 




2.99 


Status 


string 




The sleep status of the device. 

Enumeration of: 

ASLEEP 

AWAKE 




2.99 


Active 


boolean 




Whether or not this M2IVI Device is currently 
attached to this SCL instance. 
The ability to list inactive IVI2M Devices is 
OPTIONAL. If the CPE includes inactive 
I\/I2M Devices in this table. Active is set to 
false for each inactive IVI2M Device. The 
length of time an inactive M2M Device 
remains listed in this table is a local matter to 
the CPE. 




2.99 
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1 Name 


Type 


Write 


Description 


Object 
Default 


Version 


PropertyNumberOf Entries 


unsignedint 


- 


The number of entries in the Property table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNwkD 
evicelnfolnstance.{i}.Property.{i}. 


object 




This object contains an instance of a 
property extension (name value pair) for this 
AreaNwkDevicelnfolnstance instance. 
For example, if the 

AreaNwklnstance.{i}. AreaNwkType value is 
ZigBee, this AreaNwkDevicelnfolnstance 
contains ZigBee-specific parameters that are 
not formally modelled for this 
AreaNwkDevicelnfolnstance instance. 




2.99 


Name 


string 


- 


The name of the property 


- 


2.99 


Value 


string 


- 


The value of the property. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNwkl 
nstance.ji}. 


object 




The M2M Area Network information provides 
administration capabilities for remote 
management (REIVI) of M2M Devices (D', d) 
that are attached to this SCL instance. 
This object provides the administration of the 
properties needed by the SCL to remotely 
manage M2M Devices within a specific type 
of I\/I2M Area network as defined by 
AreaNwkType. 

IVIultiple instances of AreaNwklnstance with 
the same AreaNwkType is permitted. 
Section 5.3.5 of the M2M Functional 
Architecture [1] describes the REIVI 
functionality expected of a SCL for an M2M 
Device. 

At most one entry in this table can exist with 
a given value for ID. 




2.99 


ID 


string 


- 


URI [6] that represents the identifier of the 
instance. 


- 


2.99 


AreaNwkType 


string 




Devices (D' and d) that connect to an SCL 
are said to be "attached devices" and are 
organized by M2M Area Networks within the 
SCL instance. The AreaNwkType is an 
implementation-chosen string that indicates 
the type of M2M Area Network. 




2.99 


ListOfDevices 


string 




Comma-separated list of strings. Each list 
item shall be the path name of a row in the 
AreaNwkDevicelnfolnstance table, or an 
empty string. 

The list represents the M2M Devices (D', d) 
that are attached to this SCL instance that 
are within this AreaNwklnstance instance. 
The list does not contain an instance for this 
CPE. 




2.99 


PropertyNumberOf Entries 


unsignedint 


- 


The number of entries in the Property table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.AreaNwkl 
nstance.{i}.Property.{i}. 


object 




This object contains an instance of a 

property extension (name value pair) for this 

AreaNwklnstance instance. 

For example, if the AreaNwkType is ZigBee 

the AreaNwklnstance will contain ZigBee 

specific parameters that have not been 

modelled for the M2M Area network. 

At a minimum, a property instance shall exist 

that defines an attribute that describes the IP 

layer address type (e.g. IPv4, IPv6, non-IP) 

of this I\/I2M Area Network. 




2.99 


Name 


string 


- 


The name of the property 


- 


2.99 


Value 


string 


- 


The value of the property. 


- 


2.99 
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1 Name 


Type 


Write 


Description 


Object 
Default 


Version 


Device.ETSIM2M.SCL.{i}.Discovery. 


object 




Ttiis object is represents tine administration 

properties used wtien a NSCL requests 

discovery of resources wittiin ttiis SCL 

instance. 

Section 9.3.2.27 of tine IVI2IVI Functional 

Architecture [1] describes the process of 

discovery of resources within a SCL. 




2.99 


MaxNumberOfDiscovRecords 


unsignedint 


W 


The maximum number of URIs [6] for 

discovered resources contained in a 

discovery result. 

This parameter and the 

IVIaxSizeOfDiscovAnswer parameter are 

mutually exclusive in that a result can be 

limited due to the bounds of either 

parameter. 

A value of indicates that the SCL does not 

have a limit for this parameter. 




2.99 


MaxSizeOfDiscovAnswer 


unsignedint 


W 


The maximum size in bytes of the Discovery 

Answer. 

This parameter and the 

MaxNumberOfDiscovRecords parameter are 

mutually exclusive in that a result can be 

limited due to the bounds of either 

parameter. 

A value of indicates that the SCL does not 

have a limit for this parameter. 




2.99 


Device. ETSIM2M.SCL.{i}.Reregistra 
tion. 


object 




This object represents the properties and 
status necessary for a SCL to reregister with 
one or more NSCLs. 




2.99 


RegTargetNSCLList 


string 


w 


Comma-separated list of strings. The list 
represents a priority ordered set of URIs [6]. 
The item that is first in the list has the highest 
priority. 

A list item is a URI [6] string that represents a 
NSCL that this SCL instance can use in 
order to attempt registration. 
When modified the contents of this 
parameter replace the RegTargetNSCLList 
received during the bootstrap procedure. 




2.99 


RegSearchStrings 


string 


w 


Comma-separated list of strings. The list 
represents the string tokens used as keys 
when searching for this SCL instance. 
Sections 9.2.3.6.2 and 9.2.3.6.4 of the M2M 
Functional Architecture [1] describe the 
usage for this parameter. 




2.99 


RegAccessRightID 


string 


w 


URI [6] that represents the identifier of the 
access right resource. The value of this 
parameter is maintained by the NSCL and 
used by the SCL as a default access right 
identifier for re-registration to NSCLs. 




2.99 


RegExpirationDuration 


int 


w 


The duration, in seconds, that the SCL will 
use in its next re- registration attempt. Any 
negative value represents an infinite 
duration. 


-1 


2.99 


Reregistration 


boolean 


w 


The value of this parameter is not part of the 
device configuration and is always false 
when read. When set to true, triggers an 
immediate re-registration action where the 
SCL re-registers with the SCLs in the 
RegTargetNSCLList. 




2.99 


Device.ETSIM2M.SCL.{i}.Reregistra 
tion.ActionStatus. 


object 


- 


This object represents the status of the 
Reregistration action. 


- 


2.99 
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1 Name 


Type 


Write 


Description 


Object 
Default 


Version 


Progress 


unsignedlnt- 
[0:100] 




The progress, in percent, of the 
Reregistration action. The progress is 
measured from 0-100 %. A value of 
indicates that the action has not started. A 
value of 100 indicates that the action has 
completed. 




2.99 


FinalStatus 


string 




The completion status of the Reregistration 

operation. Enumeration of: 

SUCCESS 

FAILURE 




2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}. 


object 


W 


This object describes the parameters 
necessary to administer the store-and- 
forward (SAF) handling policies applied to 
requests to access remotely hosted 
resources. 

Policies are described by instances of 
SAFPolicySet. Which instances of 
SAFPolicySet are used by the SCL is 
determined by the PolicyScope parameter. 
Section 9.3.1 .5 of the M2M Functional 
Architecture [1 ] and Section 1 0.3. 1 .2.2 of the 
IVI2M mla, dia and mid Interfaces [2] 
describe the behaviour for SAF processing. 
There is at most one SAFPolicySet instance 
with the PolicyScope containing a specific 
application id (APP-ID) URI value within the 
list. 

There is exactly one SAFPolicySet instance 
with a PolicyScope value of "default". 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE shall choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 
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I Name 


Type 


Write 


Description 


Object 
Default 


Version 


PolicyScope 


string 


W 


Comma-separated list of strings. The 

parameter defines the scope of the policies 

contained in this instance of a SAFPolicySet. 

The parameter value is: 

a list of unordered set of URIs [6] that 

represents an I\/I2M application id (APP-ID) 

the value of "default" 

an empty string 

When this parameter is set to a list of 

application id (APP-ID) URIs [6], the scope 

indicates that the policies are applicable to 

requests coming from any specific 

application on that list. 

When this parameter is set to a string with 

the value "default", the scope indicates that 

the policies are the default policies for this 

SCL instance. 

When this parameter is set to an empty 

string, the value represents an unknown 

SAFPolicySet and the SAFPolicySetis not to 

be used. 


<Empty> 


2.99 


ANPPolicyNumberOfEntries 


unsignedint 


- 


The number of entries in the ANPPolicy 
table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.ANPPolicy.{i}. 


object 


w 


This table contains the SAF-handling policies 

which are controlled by the Access Network 

Provider{s). 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE shall choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 

At most one enabled entry in this table can 

exist with a given value for ANName. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 


ANName 


string 


w 


This parameter is the name of the access 
network provider and used to determine for 
which access network the policies defined in 
the ANPPolicy table will apply. 


<Empty> 


2.99 


BlockPeriodNumberOfEntries 


unsignedint 


- 


The number of entries in the BlockPeriod 
table. 


- 


2.99 


RequestCategoryNumberOf Entries 


unsignedint 


- 


The number of entries in the 
RequestCategory table. 


- 


2.99 
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1 Name 


Type 


Write 


Description 


Object 
Default 


Version 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.ANPPolicy.{i}.BIockPeriod.{i}. 


object 


W 


This table contains a list of block periods for 
aANPPolicy. 

A block period defines how long the device 
will wait before re-trying to establish 
connectivity via the access network after the 
previous attempt has failed. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE shall choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


W 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 


FailedAttempts 


unsignedint 


w 


Number of consecutively failed access 
attempts for which the BlockDuration will be 
used to block the next access attempt. 
The SCL will apply the BlockPeriod entry 
with the largest number of consecutive failed 
attempts that is smaller or equal to the actual 
number of consecutive failed attempts. 





2.99 


BlockDuration 


int 


w 


The duration, in seconds, to which to block 
further access attempts. 





2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.ANPPolicy.{i}.RequestCatego 
ry.{i}. 


object 


w 


This table contains the Request Category 
(RCAT) policy items for defining when it is 
appropriate to use the access network for 
processing requests. 

At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE shall choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 
At most one enabled entry in this table can 
exist with a given value for RCAT. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 
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[ Name 


Type 


Write 


Description 


Object 
Default 


Version 


Alias 


string(64) 


W 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 


RCAT 


string 


W 


An RCAT is a string that represents a 
request category used for policy 
enforcement. 




2.99 


ScheduleNumberOf Entries 


unsignedint 


- 


The number of entries in the Schedule table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.ANPPolicy.{i}.RequestCatego 
ry.{i}. Schedule. {!}. 


object 


w 


This table contains the schedules that define 

when it is appropriate to use the access 

network for processing requests for the 

specified value of the RCAT. 

The combination of all instances of the 

AbsTimeSpan along with the Schedules 

parameter makes up the complete schedule 

for this Schedule. 

The Schedules parameter defines a 

recurrence of the schedule and the 

AbsTimeSpan, if instances of AbsTimeSpan 

exist, these instances places constraints on 

the schedule recurrence. 

If the value of the Schedules parameter is an 

empty string, at least one instance of 

AbsTimeSpan must exist. 

Processing behaviour for the use of RCAT 

Schedules is defined in section 10.3.1.2.2 of 

the M2M mla, dia and mid Interfaces [2] 

document. 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE shall choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in 

Section 3.6.1/ [3] and described in Appendix 

11/ [3], the following mandatory constraints 

shall be enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 
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I Name 


Type 


Write 


Description 


Object 
Default 


Version 


Schedules 


string 


W 


Comma-separated list of strings. The list is a 

set of schedule strings. 

A Schedules string is a string formatted 

according to the date and time fields defined 

CRONTAB input file definition in [7]. 

The Schedules is used to set the recurrence 

of the schedule. 

The timezone used for this parameter is 

dependent upon the existence of instances 

of AbsTimeSpan for this Schedule. If 

instances of AbsTimeSpan exists, then the 

timezone of the AbsTimeSpan is used 

otherwise the UTC timezone is used for this 

Schedules parameter. 

Example of CRONTAB string: 

"* 0-6**1 -5" would mean every minute for 

the period from 0:00h to 6:00h (inclusive) on 

any week day (Monday through Friday) and 

would be represented as "*%200- 

6%20*%20*%201-5" 

"*/1 5 22-23,0-4 * * 1 -5" would mean every 1 5 

minutes for the period from 22:00h to 04:00h 

on any week day (Monday through Friday) 

and would be represented as "*/1 5%2022- 

23%2C0-4%20*%20*%201 -5". 


<Empty> 


2.99 


AbsTimeSpanNumberOf Entries 


unsignedint 


- 


The number of entries in the AbsTimeSpan 
table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.ANPPolicy.{i}.RequestCatego 
ry.{i}. Schedule. {i}.AbsTimeSpan.{i}. 


object 


w 


This object defines an instance of a time 
span used for determining an RCAT 
schedule. 

An instance of the AbsTimeSpan represents 
a time span in which the schedule recurrence 
defined in Schedules is constrained. 
AbsTimeSpan instances with unknown 
values for the StartTime or EndTime are 
ignored. 

All instances of the AbsTimeSpan within this 
Schedule shall utilize the same time zone. 
At most one entry in this table (regardless of 
whether or not it is enabled) can exist with a 
given value for Alias. On creation of a new 
table entry, the CPE shall choose an initial 
value for Alias such that the new entry does 
not conflict with any existing entries. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

if the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 
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Name 

L 


Type 


Write 


Description 


Object 
Default 


Version 


StartTime 


dateTime 


W 


Date and time that represents the start of the 

time span. 

The value 0001-01-01T00:00:00Z represents 

an unknown value. 

The device shall reject requests to set the 

StartTime value greater than the EndTime 

value. 


0001-01- 

01T00:00: 

OOZ 


2.99 


EndTime 


dateTime 


W 


Date and time that represents the end of the 

time span. 

The value 9999-1 2-31 T23:59:59Z represents 

an infinite time span from the start time. 

The value 0001-01-01T00:00:00Z represents 

an unknown value. 

The device shall reject requests to set the 

EndTime value less than or equal the 

StartTime value. 


0001-01- 

01T00:00: 

OOZ 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.M2MSPPolicy. 


object 




This object maintains the SAP handling 
policies' properties that are controlled by the 
I\/I2M service provider for a request. 




2.99 


DefaultRCATValue 


string 


w 


The default RCAT value to use for requests 
to remotely hosted resources during SAP- 
handling when no RCAT value was specified 
in the request. 


<Empty> 


2.99 


RequestCategoryNumberOf Entries 


unsignedint 


- 


The number of entries in the 
RequestCategory table. 


- 


2.99 


Device.ETSIM2M.SCL.{i}.SAFPolicy 
Set.{i}.M2MSPPolicy.RequestCateg 
ory.{i}. 


object 


w 


This object maintains a list of properties to be 

used for forwarding requests with a specified 

RCAT. 

Processing behaviour for the use of IV12M 

Service Provider policies is defined in 

Section 10.3.1.2.2.1 of the I\/I2M mla, dia and 

mid Interfaces [2] document. 

At most one entry in this table (regardless of 

whether or not it is enabled) can exist with a 

given value for Alias. On creation of a new 

table entry, the CPE shall choose an initial 

value for Alias such that the new entry does 

not conflict with any existing entries. 

At most one enabled entry in this table can 

exist with a given value for RCAT. 




2.99 


Enable 


boolean 


w 


Administratively enables or disables this 
instance. 


false 


2.99 


Alias 


string(64) 


w 


A non-volatile handle used to reference this 

instance. Alias provides a mechanism for an 

ACS to label this instance for future 

reference. 

If the CPE supports the Alias-based 

Addressing feature as defined in Section 

3.6.1/ [3] and described in Appendix 11/ [3], 

the following mandatory constraints shall be 

enforced: 

Its value shall NOT be empty. 

Its value shall start with a letter. 

If its instance object is created by the CPE, 

the initial value shall start with a "cpe-" prefix. 

The CPE shall NOT change the parameter 

value. 




2.99 


RCAT 


string 


w 


An RCAT is a string that represents a 
request category used for policy 
enforcement. 




2.99 
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1 Name 


Type 


Write 


Description 


Object 
Default 


Version 


TolerableDelay 


int 


W 


The tolerable duration, in seconds, that a 

request of the given RCAT category can be 

pending in SAF handling when a request 

from an M2M Application does not specify a 

tolerable delay. 

Any negative value represents an infinite 

duration. 





2.99 


Thresh 


unsignedint 


W 


The threshold of maximum number of 
pending requests permitted to be held for a 
specified RCAT. 

A value of indicates that the request should 
be transmitted immediately. 





2.99 


Mem 


String (16) 


w 


This parameter defines the maximum size of 
the request queue for pending requests 
permitted to be held for a specified RCAT. 
The format of the string is an integer with an 
appended memory unit (B - Bytes, K - 1024 
Bytes, M - 1048576 Bytes, G -1073741824 
Bytes, T - 1 09951 1 62/ / /6 Bytes). 
When the value is an empty string the 
memory threshold criteria for the associated 
RCATList will be ignored in SAF handling. 
([0-9]{0,1 5}?[BKMGT])|(<Empty>) 




2.99 


RankedANList 


string 


w 


Comma-separated list of strings. Each list 
item shall be the path name of a row in the 
ANPPolicy table. If the referenced object is 
deleted, the corresponding item shall be 
removed from the list. The list is a prioritized 
set of Access Networks where the 
preference of using an Access Network is 
based on order of the list items with the 
lowest order list item as the most preferred 
Access Network. 


<Empty> 


2.99 



£75/ 



19 



ETSI TS 103 093 VI .2.1 (2013-03) 



History 



Document history 


VI. 1.1 


May 2012 


Publication 


Vl.2.1 


March 2013 


Publication 


V2.1.1 


March 2013 


Publication 















£75/ 



